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LiveCode 8.0.0 Release Notes 


e Overview 


o Simplify design with widgets 

o Extend Livecode with LiveCode Builder 
°o Deploy to the browser with HTML5 

o More! 


e Known issues 
e Platform support 


o Windows 
o Linux 

o Mac 

o iOS 

o Android 
o HTML5 


o Installation 

o Uninstallation 

o Reporting installer issues 

© Activating LiveCode Indy or Business edition 

© Command-line installation 

© Command-line uninstallation 

© Command-line activation for LiveCode Indy or Business edition 


e Engine changes 


o MergExt included in the IDE (8.0.0-rc-1) 

o Improve error message when calling LCB library function incorrectly. (8.0.0-rc-1) 

o Ensure unload extension reports appropriate status in 'the result’ (8.0.0-rc-1) 

© Showthe prompt in file dialogs on El Capitan (8.0.0-rc-1) 

o Widget element chunk (8.0.0-dp-16) 

o Removal of CEF support from OS X version of revBrowser external and 8.0 browser 
widget. (8.0.0-dp-16) 

o Replacing text in fields (8.0.0-dp-16) 

o Themed UI fonts (8.0.0-dp-16) 

o Standard help cursor now works on Windows (8.0.0-dp-16) 

o Deploy 64-bit Mac OS X standalones (8.0.0-dp-15) 

o Selected objects act as though they are on the top layer (8.0.0-dp-15) 

o TIF font support in HTML5 standalones (8.0.0-dp-15) 

o Faster Unicode text processing (8.0.0-dp-14) 

° More native-looking stack theming (8.0.0-dp-14) 

° No blocking syntax in HTML5 standalones (8.0.0-dp-14) 

o Packaged extension name changes (8.0.0-dp-13) 

°o Improvements for saving in old stack file formats (8.0.0-dp-13) 

o Use more accurate measurements when laying out text. (8.0.0-dp-12) 

°o Improve printing on Linux (8.0.0-dp-11) 

o Make odd numbers of dashes work properly. (8.0.0-dp-11) 
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© Correct lineOffset / itemOffset mode in wholeMatches mode. (8.0.0-dp-11) 

o Consistent value union and intersect semantics (8.0.0-dp-10) 

o Native string operations are much faster compared to LiveCode 7 (8.0.0-dp-10) 
o New "documentFilename" stack property (8.0.0-dp-9) 

o Update the Mac OS X printer code for 64-bit compatibility (8.0.0-dp-9) 

o Make "the effective rect of stack" more accurate on Linux (8.0.0-dp-9) 

o DataGrid added to the Standalone Settings script libraries list (8.0.0-dp-8) 

°o Position resize handles outside object rectangle (8.0.0-dp-8) 

o SSL Support for PostgreSQL Connections (8.0.0-dp-8) 

© Improved clipboard and drag-and-drop support (8.0.0-dp-8) 

eo Changed behaviour of submenu menu items (8.0.0-dp-8) 

o New "scriptOnly" stack property (8.0.0-dp-5) 

o New "popup widget" command (8.0.0-dp-5) 

o NewHTML5 deployment platform for LiveCode apps (8.0.0-dp-4 - experimental) 
o New "metadata" image property (8.0.0-dp-3) 

o Extensions can be loaded from raw data (8.0.0-dp-3) 

o LiveCode Builder (8.0.0-dp-1) 

°o Specific engine bug fixes 


e IDE changes 


o Relativize appropriate stackFile paths. (8.0.0-rc-1) 

o Remove non-core widgets for LiveCode 8 (8.0.0-dp-16) 

o colorList property editor (8.0.0-dp-15) 

o Widget default scripts (8.0.0-dp-15) 

o LCB Test Stack (8.0.0-dp-15) 

o Remove reviDEStacklsScriptOnly (8.0.0-dp-14) 

o Menubar Icons (8.0.0-dp-14) 

o Project Browser selected object (8.0.0-dp-14) 

o Dictionary data build location (8.0.0-dp-13) 

o Documentation API (8.0.0-dp-12) 

o Extension folder locations within the IDE (8.0.0-dp-9) 

o Property Inspector editorList editor (8.0.0-dp-8) 

o Property Inspector tabs display icons or labels (8.0.0-dp-8) 

o Property Inspector tabs have large icons by default (8.0.0-dp-8) 
o Per-version IDE stack filenames (8.0.0-dp-6) 

o Variable viewer resizable columns (8.0.0-dp-6) 

o General IDE improvements (8.0.0-dp-3) 

o Updated Property Inspector with support for widgets (8.0.0-dp-3) 
° Specific IDE bug fixes 


e LiveCode Builder changes 


o LiveCode Builder Host Library 

o LiveCode Builder Standard Library 
o LiveCode Builder Language 

o LiveCode Builder Tools 

© Specific LCB bug fixes 


e LiveCode extension changes 


o Navigation Bar widget 
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© Switch Button widget 

o Header Bar widget 

o Line Graph widget 

o Gradient Ramp Editor widget 
° SVG Icon widget 

o Palette Actions widget 

° Clock widget 

o Browser widget 

o Tree View widget 

o Icon Picker widget 

© Segmented Control widget 
° Icon SVG Library 

o JSON Library 

o Widget Utilities module 

° Specific extension bug fixes 


e Dictionary additions 
e Previous release notes 


Ove a \\ 


LiveCode 8.0 brings important new capabilities to all LiveCode developers: 
e Use newcustom controls and libraries in your applications, including a new browser widget. 
e Extend LiveCode with the new LiveCode Builder language 
e Deploy to HTML5 and run your application in a web browser 


e Many other improvements! 


Simplify design with widgets 


With LiveCode 8.0, your apps are set free from using the small range of user interface controls 
that were previously available in LiveCode. The LiveCode engine now lets you load custom 
controls, called widgets, and use them in your apps just like any other control. 


LiveCode comes with a selection of widgets that simplify creating many commonly-needed sets of 
controls in mobile apps, and if they aren't enough, you can download and install widgets created 
by members of the LiveCode development community and third-party vendors. 


One of the most exciting new widgets introduced in LiveCode 8.0 is the browser widget. It replaces 
the revBrowser external with a much more powerful and flexible browser control that's easier to 
use and more reliable. 


The LiveCode IDE has also been extended and revised in order to support widgets and other 
extensions. Widgets are now available in the "Tools" palette, and installed extensions can be 
viewed in the "Extension Manager". The dictionary has been extended to include extension 
documentation. 
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Extend Livecode with LiveCode Builder 


In LiveCode 8.0, the well-known LiveCode scripting language is joined by a brand new 
programming language called LiveCode Builder. LiveCode Builder looks a lot like LiveCode script, 
and should be easy to learn for any experienced LiveCode developer. 


Using LiveCode Builder, it is now possible to extend LiveCode with new controls and libraries 
without any need to program in C or C++. The IDE has a new "Extension Builder" tool that helps 
developers test, debug and package their extensions. 


For more information, please refer to the "Extending LiveCode" guide and the "LiveCode Builder" 
section of the dictionary. 


Note: LiveCode Builder is a new and experimental language. There is no stability guarantee for 
the language or its standard libraries. Be aware that the language syntax or features may change 
incompatibly in future versions of LiveCode! 


Deploy to the browser with HTML5 


The LiveCode 8.0 engine nowruns on a new platform: the web browser. The LiveCode engine now 
runs as a JavaScript library in an HTML page, allowing users to run your application without having 
to install anything. 


For more information, please refer to the "HTML5 Deployment" guide. 


Note: The HTML5 platform is very different to the other platforms that LiveCode supports, and 
many engine features are either unsupported or work differently. 


More! 
LiveCode 8.0 includes many other enhancements, including: 
e more powerful and complete clipboard access, sponsored by FMProMigrator 


e 64-bit Mac standalone deployment, SSL support for PostgreSQL connections, and "find and 
replace" that preserves text style, all sponsored by the community Feature Exchange 


e optimised Unicode text processing 

e Unicode printing on Linux 

e anewJSON library extension 

e greatly improved native theming on desktop platforms 


e anewlIDE Start Center and interactive tutorial 


KNOWDISSUCS SCS 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 
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e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 


The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 
LiveCode supports Linux installations which meet the following requirements: 
e Supported CPU architectures: 


° 32-bit or 64-bit Intel/AMD or compatible processor 
° 32-bit ARMv6 with hardware floating-point (e.g. RaspberryPi) 


e Common requirements for GUI functionality: 


°0 GTK/GDK/Glib 2.24 or later 

o Pango with Xft support 

° esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

© Icms (optional, required for color profile support in images) 
© gksu (optional, required for privilege elevation support) 


e Requirements for 32-bit Intel/AMD: 
° glibc 2.11 or later 
e Requirements for 64-bit Intel/AMD: 


° glibc 2.13 or later 
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e Requirements for ARMv6: 
° glibc 2.7 or later 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 


IOS 
iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 7.3 on MacOS X 10.11 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on Yosemite, you can add Xcode 5.1 in the Mobile Support preferences, 
to let you test your stack on the /OS Simulator 7.1. 


We currently support the following iOS Simulators: 


e 6.1 
e 7.1 
e 8.2 
e 9.2 
e 9.3 


Android 
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LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not yet officially 
supported. 


HTML5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


SS Ls 


Installation 


Each version of LiveCode installs to its own, separate folder, to allow multiple versions of LiveCode 
to be installed side-by-side. On Windows (and Linux), each version of LiveCode has its own Start 
Menu (or application menu) entry, and on Mac OS X, each version has its own app bundle. 


The default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 
Linux /opt/livecode/livecode-<version> 


MacOS X /Applications/LiveCode <version>.app 
The installations when installing for "This User" are: 


Platform Path 


LiveCode 8.0.0 Release Notes 4/28/16 


Piadeefm <user roaming app data folder>PRattRev/Components/LiveCode 
<version> 


Linux ~/.runrev/components/livecode-<version> 


MacOS X_ ~/Applications/LiveCode <version>.app 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 
Linux <home>/.runrev/logs 


Mac OS X <home>/Library/Application Support/Logs/RunRev 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 
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Command-line installation 


It is possible to invoke the installer from the command-line on Mac, Linux and Windows. When 
doing command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
-allusers 
for the current user only. 
: PI hortcut on the Desktop (Wi -onl 
Jee echonza: ace a shortcut on the Desktop (Windows-only) 
-Startmenu Place shortcuts in the Start Menu (Windows-only) 
- location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
Steep luneaitlle The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <installer> install noui [OPTION ...] 


On Mac OS X, you need to do: 


<installer>/Contents/MacOS/installer install noui *options* 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 
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Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <Livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 
activation files can be downloaded from the My Products page in the LiveCode account 


management site. 

It is also possible to deactivate LiveCode with: 

<livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <livecode> activate -file LICENSE -passphrase SECRET 
start /wait <livecode> deactivate 


On Mac OS X, you need to do: 
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<livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<livecode>/Contents/MacOS/LiveCode deactivate 


Fngine changes SCS 


MergExt included in the IDE (8.0.0-rc-1) 


The MergExt externals are now included as part of the IDE by default and are loaded at startup 
(where the external supports the platform). 


Improve error Heels when calling LCB library function 
incorrectly. (8.0.0-rc-1) 


If a handler in an LCB library is called with the wrong number of arguments then the engine will 
now throw either a "too few arguments" or "too many arguments" error. 


Ensure unload extension reports appropriate status in 'the 
result’ (8.0.0-rc-1) 


If 'unload extension’ is called on a module which has not been loaded, the result will be set to 
"module not loaded". 


If 'unload extension’ is called on a module which is currently in use, the result will be set to 
"module in use". 


Show the prompt in file dialogs on El Capitan (8.0.0-rc-1) 


The open file/folder dialog has changed significantly in El Capitan and no longer has the same 
flexibility as in previous Mac OS versions. 


On El Capitan, the prompt will now be displayed as a title but any specified title will not be 
displayed. 


Widget element chunk (8.0.0-dp-16) 
In order to facilitate more efficient manipulation of a widget's underlying data, the following 
LiveCode Script syntax has been added: 


the <property> of { element <index> , of } <widget> 


This syntax maps to the following LiveCode Builder handlers: 


e Set<Property>0fElement(<path>, <value>) 
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e Get<Property>0fElement (<path>) 


For example, once the above handlers have been added to the Tree View widget, we could use 
the arrayData of element "a" of element "b" of widget "Tree View" in order to 
access the data tArray["b"]["a"], where tArray is the Tree View's underlying array. 


This allows modification of a particular node of the Tree View without causing a costly complete 
recalculation. 


The <index> in the element chunk expression may also be an indexed array which keeps the 
same sense as indexing, i.e. if tArray[1] is "x" and tArray[2] is "y", then 


element y of element x of widget 1 === element tArray of widget 1 


Currently this syntax is limited to property-based expressions only - use of the element chunk in 
any other context will result in an error. 


Removal of CEF support from OS X version of revBrowser 
external and 8.0 browser widget. (8.0.0-dp-16 


Due to the lack of support for 32-bit Chromium on Mac OS X (and thus Chromium Embedded 
Framework) we will no longer be using libCEF to provide an embedded browser on OSX, either with 
the revBrowser external, or the new browser widget. 


If you currently use revBrowser and the revBrowserOpenCEF command to create the browser, 
this will no longer function. We advise you to switch to using revBrowserOpen when your 
application is running on OSX. 


The browser widget will continue to function as before, as the implementation has already been 
changed to use the OSX WebView class by default. 


Replacing text in fields (8.0.0-dp-16) 


There is a new form of the replace command which works directly with fields: 


replace <pattern> with <text> in <field chunk> (replacing | preserving) 
styles 


The replacing form of the command replaces each occurrence of 'pattern' in the specified field 
chunk with 'text', removing all styling from the found range. 


The preserving form of the command replaces each occurrence of 'pattern' in the specified field 
chunk with 'text', retaining the style which was present on the first char of the occurrence of the 
pattern for the whole of the replacement. 


This feature was sponsored by the community Feature Exchange. 


Themed UI fonts (8.0.0-dp-16) 
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LiveCode 8.0 has improved the native look-and-feel of stacks written for desktop platforms, 
particularly when it comes to fonts. However, LiveCode lacked an easy way to request the use of 
an appropriately themed font explicitly. 


A number of special font names have now been added to LiveCode so you can, for example, set 
the font of a control to the default font used for buttons. To find out more, see the dictionary entry 
for the fontNames function. 


Standard help cursor now works on Windows (8.0.0-dp-16) 


If the standard cursors are not overriden on Windows, then they now work correctly. 


Deploy 64-bit Mac OS X standalones (8.0.0-dp-15) 


You can now deploy both 32-bit and 64-bit standalones for Mac OS X, and you can select which 
engines you'd like to include in the standalone builder. 


This feature was sponsored by the community Feature Exchange. 


ee objects act as though they are on the top layer (8.0.0- 
p- 


The selection handles are now drawn over the top layer, and the selected objects are checked first 
for mouse focus to enable resizing and moving of selected objects that are underneath others. 


TTF font support in HTML5 standalones (8.0.0-dp-15) 


Additional TTF fonts can now be included when deploying HTML5 standalones. Add them to the 
standalone using the "Copy Files" page of the standalone builder. 


Faster Unicode text processing (8.0.0-dp-14) 
Text processing operations involving Unicode strings are now about 25% faster. 


The engine now has its own implementation of the Unicode 'grapheme cluster breaking' 
algorithm. This means that it no longer needs to incur the penalty of initialising an ICU grapheme 
break iterator, which involves making a complete copy of the target string. 


More native-looking stack theming (8.0.0-dp-14) 


The default appearance of stacks on desktop platforms has been updated to more closely match 
the appearance of native apps. This particularly affects OSX and Linux apps. 


One effect of this is that the default text size is now different for different types of controls. As this 
may cause layout issues for existing stacks, it is possible to set the theme property of a stack, 
card or control to "legacy" to restore the old behavior. The new behavior can be explicitly 
requested for an object by setting the theme to "native". 


13 


LiveCode 8.0.0 Release Notes 4/28/16 


No blocking syntax in HTML5 standalones (8.0.0-dp-14) 


In LiveCode 8.0.0-dp-11, changes were made to the HTML5 standalone engine to enable the use 
of the wait command (and related syntax; see bug 16076. These changes made the HTML5 
engine run unacceptably slowly, and have now been removed. 


Instead of using wait in stacks designed for HTML5 deployment, you can still use 
send <message> in <time>. 


Packaged extension name changes (8.0.0-dp-13) 


Earlier versions of the widgets and libraries which are bundled with the IDE were named 
inconsistently. 


Now all LiveCode extensions are named either com.livecode.widget. or 
com.livecode.library.. 


Their directories in the installed LiveCode bundle have also been updated to match. 


Note: This change will break some stacks that have widgets saved on them, or scripts which refer 
to a widget by its kind. 


Improvements for saving in old stack file formats (8.0.0-dp-13) 
It is now possible to specify a version of the stack file format to be used when saving directly with 


the save command, by using the save STACK with format VERSION form of the command. 


You can request the latest supported file format using the save STACK with newest format 
form. 


The stackFileVersion global property is now deprecated, and should not be used in new 
stacks. 


ree accurate measurements when laying out text. (8.0.0- 
p- 


The measurements used by LiveCode to lay out text (the text "metrics") in versions prior to 8 
were optimised for low-resolution bitmap fonts. In LiveCode 8, more accurate measurements are 
now being used by the field and other controls. 


For many existing stacks, the most visible change is that lines in the field are now closer together 
and better match the text display in other programs. If this is not desirable, a fixed line height can 
be set on the field to emulate the old behaviour. 


Improve printing on Linux (8.0.0-dp-11) 


The Linux printing commands nowuse the revpdfprinter external to generate a PDF to send 
through the system printing process. 


Among other things, this means that there is now full support for Unicode text. 
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Note: To use printing on Linux in standalones you must now make sure you include revpdfprinter. 
Make sure the appropriate checkbox is highlighted in the standalone builder. 


Make odd numbers of dashes work properly. (8.0.0-dp-11) 


If the dashes property of a graphic was set to an odd number of items, then the pattern would 
not replicate correctly. 


Correct lineOffset / itemOffset mode in wholeMatches mode. 
(8.0.0-dp-11) 


The lineOffset and itemOffset functions now work correctly in wholeMatches mode in that they will 
not stop after the first occurrance of needle. 


Consistent value union and intersect semantics (8.0.0-dp-10) 


The array union and intersect commands and their recursive counterparts now follow a 
consistent recipe to produce their result. 


union <left> with <right> nowhas the semantics of the following LiveCode function: 


function ArrayUnion(pLeft, pRight, pRecursive) 
repeat for each key tKey in pRight 
if tKey is not among the keys of pLeft then 
put pRight[tKey] into pLeft[tKey] 
else if pRecursive then 
put ArrayUnion(pLeft[tKey], pRight[tKey], true) into pLeft[tKey] 
end if 
end repeat 


return pLeft 
end ArrayUnion 


and intersect <left> with <right> the following: 
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function ArrayIntersect(pLeft, pRight, pRecursive) 
repeat for each key tKey in pLeft 
if tKey is not among the keys of pRight then 
delete variable pLeft[tKey] 
else if pRecursive then 
put ArrayIntersect(pLeft[tKey], pRight[tKey], true) into 


pLeft[tKey] 
end if 
end repeat 


return pLeft 
end ArrayIntersect 


Previously the semantics for intersect were different depending on whether the intersect was in a 
recursive step or not. The two affected forms are: 


intersect <string> with <value> 


e in LiveCode 6.7, <string> becomes empty. 
e in LiveCode 8.0, <string> is unchanged. 


put "a" into tLeftArray[1][1] 
put "b" into tRightArray[1] 
intersect tLeftArray with tRightArray recursively 


e in LiveCode 6.7 tLeftArray is unchanged. 
e in LiveCode 8.0, tleftArray[1] becomes empty 


Native string operations are much faster compared to LiveCode 
7 (8.0.0-dp- OF 


The performance of native string operations has been vastly improved, with many achieving 
similar speeds to those in LiveCode 6.7. 


New "documentFilename" stack property (8.0.0-dp-9) 
A new property has been added to specify the file path to the file that a stack represents. 


On Mac OS X, setting the documentFilename property will set the represented filename of the 
window. The window will show an icon for the file next to the window title. 


On other platforms there is no visual representation of the association between the stack and the 
document file, but the property may still be used to manage the association. 
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(Po Od the ie OS X printer code for 64-bit compatibility 


Due to changes in Apple's APIs for printing, there are some (very small) differences in printing 
behaviour. In 64-bit engines, no dialogue will be displayed while spooling to the printer as Apple no 
longer provides it. 


Additionally, the API previously used to implement the printerSettings property was deprecated 
by Apple. The engine has been updated to use the newAPI, and compatibility between the binary 
strings returned by the two APIs cannot be guaranteed. 


Make "the effective rect of stack" more accurate on Linux 
(8.0.0-dp-9) 


Because the engine began using GDK on Linux in LiveCode 7.0, there is nowa better method for 
computing the effective rect of a window. The engine has been updated to use this method, 
rather than the heuristic which was there before. 


DataGrid added to the Standalone Settings script libraries list 
(8.0.0-dp-8) 


Formerly, the DataGrid library was only included in a standalone application if the stack saved as a 
standalone was using a DataGrid. When the stack saved did not use DataGrid, but loaded a stack 
which used it, the DataGrid library was not saved with the standalone, and the DataGrid would not 
work in the loaded stack. 


To correct this, "DataGrid" has been added to the list of "Script Libraries" in the "Standalone 
Settings" dialog. You can now force the inclusion of the DataGrid library, to ensure that any stack 
loaded by the standalone can use DataGrids. 


Position resize handles outside object rectangle (8.0.0-dp-8) 


The resize handles of a selected object are now outside the rect of the object. There is no longer a 
minimum width and height of an object when resizing via handles. 


SSL Support for PostgreSQL Connections (8.0.0-dp-8) 


The PostgreSQL database driver has been updated to support secure connections. The desired 
SSL connection options can be specified as key value pairs in the additional parameters of 
revOpenDatabase. 


The syntax for connecting to PostgreSQL databases is now as follows: 


revOpenDatabase("postgresql", host[:port], databasename, 
[username], [password], [ssloption=*ssloptionvalue], 
-) 


For full information on the new parameters see the dictionary entry for revOpenDatabase. 
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This feature was sponsored by the community Feature Exchange. 


Improved clipboard and drag-and-drop support (8.0.0-dp-8) 


It is now possible to put multiple types of data on the clipboard at the same time. For example, 
you can put an image on the clipboard along with text describing the image and some private 
data associated with the image. 


For more information, see the fullClipboardData and fullDragData entries in the dictionary. 


For apps requiring more sophisticated clipboard functionality, new rawClipboardData and 
rawDragData properties have also been added. These provide low-level access to the system 
clipboard. 


This feature was sponsored by FMProMigrator. 


Changed behaviour of submenu menu items (8.0.0-dp-8) 


Previously, clicks to menu items that open submenus would dismiss the menu and send a 
mouseRelease message. Unfortunately, this did not match the conventions of modern user 
interfaces where these clicks are ignored. This can be seen on OSX where the system's menus 
are used instead of being emulated by LiveCode. 


Now, clicking on the item that anchors a submenu will send the mouseRelease message as 
before but, if that message is not handled or is passed, the click will be ignored and the menu will 
remain on-screen. 


To restore the old behaviour, handle the mouseRelease message without passing. To add the 
new behaviour to existing code that handles the mouseRelease message, add a pass 
command to the end of the handler. 


New "scriptOnly" stack property (8.0.0-dp-5) 


A new boolean stack property scriptOnly has been added. If its value is "true", the stack will be 
saved as script only. A script only stack does not retain any objects or custom properties when it 
is saved. 


New "popup widget" command (8.0.0-dp-5) 
A new popup widget command has been added which opens a widget within a popup window. 
The syntax is: 


popup widget <kind> [ at <location> ] [ with properties <propertyArray> ] 


For example, this command can be used to showa color picker widget as a popup: 
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local tProps 

-- Set the size of the popup 

DD Uiteme Om Opel OS Ohmi Omer OWS | amtse Cams 

-- Set the initial color value 

oun TI O.5" aime@ cPreos|| “ambclelColor”) 


-- Show the widget in a popup window 
popup widget "com.example.mycolorpicker" at the mouseloc with properties 
tProps 


New HTML5 deployment platform for LiveCode apps (8.0.0-dp- 
4 - experimental) 


The LiveCode engine will now run in web browsers that support HTML5. This means that you can 
now deploy simple LiveCode apps to users without any installation required. 


To deploy a stack as an HTML5 application, enable the "Build for HTML5" checkbox on the "HTML5" 
page of the standalone settings window, and then generate the standalone in the normal way. 


For more information on HTML5 deployment, including options for embedding LiveCode 
standalones in web pages, please see the "HTML5 Deployment" guide in the IDE dictionary. 


Important: This feature is currently experimental. This means it may not be complete, or may fail 
in some circumstances that you would expect it to work. Please do not be afraid to try it out as we 
need feedback to develop it further. 


New "metadata" image property (8.0.0-dp-3) 


A new read-only metadata property of image controls has been added. It provides access to the 
metadata in the image file. The returned array is in the same format as that used for the export 
command. 


If no metadata is found then the property returns empty rather than an array with empty 
elements. Currently the only metadata key that is implemented is density, which can be used 
to determine pixel density in pixels per inch. Metadata is currently only parsed from JPEG and PNG 
file formats. 


Usage example: 


put the metadata of image 1 into metadataArray 

set the width of image 1 to the width of image 1 div 
(medatadaArray["density"] / 72) 

set the height of image 1 to the height of image 1 div 
(medatadaArray["density"] / 72) 


Extensions can be loaded from raw data (8.0.0-dp-3) 
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LiveCode Builder extensions can now be loaded from data values by using the new 
load extension from data <data> syntax. 


LiveCode Builder (8.0.0-dp-1) 


LiveCode Builder Language 


LiveCode Builder (LCB) is a variant of the current LiveCode scripting language (LiveCode Script) 

which has been designed for "systems" building. It is statically compiled with optional static typing 
and direct foreign code interconnect (allowing easy access to APIs written in other languages such 
as C). The compiled bytecode can then be packaged together with any required resources (icons, 


documentation, images, etc) into a .lce extension package. 


Unlike most languages, LiveCode Builder (LCB) has been designed around the idea of extensible 
syntax. The core language is very small — comprising declarations and control structures — with 
the majority of the language syntax and functionality being defined in modules written in LCB 
itself. 


Note: It is an eventual aim that control structures will also be extensible. However, this has not 
yet been implemented. 


The syntax will be familiar to anyone who has coded with LiveCode Script. However, LCB is a great 
deal more strict. The increased strictness is because LCB is intended to eventually be compilable 
to machine code, with the performance and efficiency you'd expect from any ‘traditional’ 
programming language like C or C++. Over time we hope to move the majority of 
implementation of the whole LiveCode system over to being written in LCB. 


Note: One of the principal differences is that type conversion is strict. There is no automatic 
conversion between different types, such as between numbers and strings. conversion must be 
explicitly specified using syntax (currently this is done using syntax like 

<expression> parsed as number and <expression> formatted as string. 


Extensions 


There are two types of extensions which can be written in LiveCode Builder: widgets and libraries. 
All installed extensions appear in the new "Extension Manager" stack, which can be opened from 
the "Tools" menu. 


An LCB library is a new way of adding functions to the LiveCode message path. Public handlers in 
loaded LCB libraries are available to call from LiveCode Script. 


A widget is a newtype of custom control which, once compiled and packaged, can be loaded 
into the IDE. Using the widget is no different from any of the classic LiveCode controls you've been 
used to. Simply drag it onto a stack and start interacting with it as you would any another control. 
You can reference the widget in script both as a control: 


set the name of the last control to "clock" 


and more specifically as a widget: 
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set the tooltip of widget 1 to "This is my nice new clock widget" 


Getting Started 


To get started with LiveCode Builder, click on the "Dictionary" icon in the IDE toolbar, select the 
"Guide" tab and then "Extending LiveCode" from the drop-down menu. This will show you the user- 
guide on getting started with writing widgets and libraries in LCB. 


Alternatively, you can start by looking at some of the extensions shipped with LiveCode 8.0. The 
source and other resources for these are located in the extensions sub-folder of your LiveCode 
installation directory. 


LCB source files are named *.lcb and can be edited with a text editor of your choice. For 
example, there is a language-livecode package available for the Atom editor which provides 
syntax highlighting and autocompletion when editing LCB source code. 


Specific engine bug fixes 


e Bugs fixed in 8.0.0: 13141, 16191, 16749, 16848, 17098, 17222, 17246, 17309, 
17377, 17382, 17391, 17408, 17411, 17413, 17422, 17425, 17430, 8710. 

e Bugs fixed in 8.0.0-rc-1: 11118, 15452, 15671, 15965, 16166, 16260, 16264, 16300, 16508, 
16790, 16849, 16886, 16918, 16936, 16959, 16970, 16996, 17040, 17042, 17071, 17072, 
17088, 17109, 17112, 17122, 17131, 17138, 17147, 17154, 17163, 17173, 17183, 17186, 
17190, 17194, 17199, 17213, 17214, 17216, 17217, 17245, 17247, 17248, 17251, 17255, 
17271, 17273, 17281, 17327, 17334, 17338, 17342, 17347, 17354. 

e Bugs fixed in 8.0.0-dp-16: 13723, 16145, 16244, 16357, 16560, 16779, 16888, 16917, 
16926, 16950, 16953, 16962, 16968, 16972, 16977, 16980, 16991, 17008, 17026, 17029, 
17032, 17038, 17052, 17068, 17082, 17083, 17084, 17099, 17117. 

e Bugs fixed in 8.0.0-dp-15: 14361, 14840, 15811, 15931, 15938, 16200, 16431, 16456, 
16568, 16603, 16630, 16633, 16707, 16747, 16754, 16756, 16795, 16813, 16844, 16875, 
16921, 16929, 16944, 2670, 6706. 

e Bugs fixed in 8.0.0-dp-14: 14589, 16033, 16186, 16303, 16436, 16478, 16619, 16647, 
16705, 16712, 16722, 16738, 16740, 16742. 

e Bugs fixed in 8.0.0-dp-13: 15970, 16267, 16351, 16415, 16533, 16539, 16615, 16642, 
16644, 16666, 16667, 16686, 16691, 16696, 16699, 16703. 

e Bugs fixed in 8.0.0-dp-12: 15231, 15811, 16186, 16448, 16543, 16599. 

e Bugs fixed in 8.0.0-dp-11: 16294, 16460, 16474, 16497, 16512, 16522, 16529, 16530. 

e Bugs fixed in 8.0.0-dp-10: 15811, 15819, 16008, 16219, 16360, 16372, 16405, 16417, 
16440, 16451, 16458. 

e Bugs fixed in 8.0.0-dp-9: 11923, 15097, 15617, 15866, 15984, 16250, 16313, 16345, 
16363, 16365, 16367. 

e Bugs fixed in 8.0.0-dp-8: 11854, 16161, 16202, 16256, 16272, 16276, 16323, 16324. 

e Bugs fixed in 8.0.0-dp-7: 15811, 15811, 15811, 16073, 16089, 16094, 16096. 

e Bugs fixed in 8.0.0-dp-6: 15197, 15981, 16032. 

e Bugs fixed in 8.0.0-dp-5: 13694, 14837, 14970, 15129, 15345, 15798, 15805, 15808, 
15811, 15836, 15845, 15846, 15848, 15868, 15870, 15897. 

e Bugs fixed in 8.0.0-dp-4: 15752. 

e Bugs fixed in 8.0.0-dp-3: 14961, 14978, 15056, 15156, 15214, 15286, 15358, 15378, 
15405, 15509, 15605, 15618, 15620, 15630. 
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e Bugs fixed in 8.0.0-dp-1: 14538, 14602, 14851. 


Relativize appropriate stackFile paths. (8.0.0-rc-1) 


When adding a stackFile to a stack with a filename, the IDE will now relativize the referenced 
stack's path if it is in the same folder, or a folder beneath that of the target stack. 


Remove non-core widgets for LiveCode 8 (8.0.0-dp-16) 


Some widgets were removed from the IDE, since LiveCode 8.0.0 will lack some features required 
to make them work well: 


e checkbox 

e progressbar 
e pushbutton 
e radiobutton 
e selector 


Additionally, some widgets intended for use internally by the IDE were hidden from the tools 
palette: 


e colorswatch 
e gradientrampeditor 


colorList property editor (8.0.0-dp-15) 


The colorList property editor has been removed. The editorList property editor should be used 
instead, with "com.livecode.pi.color" as the subeditor. 


Widget default scripts (8.0.0-dp-15) 


When opening the code editor for a widget, it will now be prepopulated by a default script, if it is 
provided by the widget developer. The default script is contained in a script-only stack file in the 
widget's support folder. 


The stack file must be named defaultscript.livecodescript, and the stack itself must be 
named <widget id>. DefaultScript, for example 
com. Livecode.widget.navbar. DefaultScript. 


LCB Test Stack (8.0.0-dp-15) 


Support for a stack named test.livecode to be placed in the extension directory which if found will 
be opened instead of creating a new stack when an extension is loaded by the Extension Builder. 
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Remove reviDEStacklsScriptOnly (8.0.0-dp-14) 


The revIDEStackIsScriptOnly function has been removed from the IDE library, since the 
scriptOnly property of stacks has been added. 


Menubar Icons (8.0.0-dp-14) 


The menubar has been revamped with new, more modern icons, including high-res versions for 
retina displays. 


Project Browser selected object (8.0.0-dp-14) 


The project browser now displays the selected objects with a dotted line around the relevant 
controls. A contextual menu item has been added to each object, "Show In Project Browser", 
which scrolls the project browser view to the object in question. 


Dictionary data build location (8.0.0-dp-13) 


Previously the IDE would try to build dictionary data internally, which was a problem for the 
installed application on Windows and Linux (as the location was not necessarily writable). 


Now the data is built and modified in an appropriate ‘Application Support' folder, or equivalent. 
This also allows direct navigation to specific dictionary entries via the 'launch documentation’ 
button / 'Find in Docs' contextual menu item in the script editor, and the 'Show Documentation’ 
contextual object menu item, in an external browser window on platforms where the browser 
widget is not available. 


Documentation API (8.0.0-dp-12) 


There is nowa documentation API used in the IDE, and available for use by plugin authors and 
toolmakers. 


It consists of the following functions: 


e ideDocsFetchLCSData pEntryName : Fetch the data for entries with name pEntryName 
in the LiveCode Script dictionary. 

e ideDocsFetchLCSDataOfType pEntryName, pType: Fetch the data for the entry with 
name pEntryName and type pType in the LiveCode Script dictionary. 

e ideDocsFetchLCSElementOfType pEntryName, pType, pElement: Fetch the data for 
the docs element pElLement with entry name pEntryName and type pType in the 
LiveCode Script dictionary. 


e ideDocsFetchLCSEntries: Fetch all the data for entries in the LiveCode Script dictionary. 


e ideDocsFetchLCBData pEntryName : Fetch the data for entries with name pEntryName 
in the LiveCode Builder dictionary. 


e ideDocsFetchLCBDataOfType pEntryName, pType: Fetch the data for the entry with 
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name pEntryName and type pType in the LiveCode Builder dictionary. 

e ideDocsFetchLCBElementOfType pEntryName, pType, pElement: Fetch the data for 
the docs element pElement with entry name pEntryName and type pType in the 
LiveCode Builder dictionary. 

e ideDocsFetchLCBEntries: Fetch all the data for entries in the LiveCode Builder 
dictionary. 


To fetch the entries for a specific extension, use the following: 


e ideDocsFetchExtensionData pID, pEntryName : Fetch the data for entries with name 
pEntryName in the API for the extension with id pID. 

e ideDocsFetchExtensionDataOfType pID, pEntryName, pType: Fetch the data for the 
entry with name pEntryName and type pType in the API for the extension with id pID. 

e ideDocsFetchExtensionElementOfType pID, pEntryName, pType, pElement: Fetch 
the data for the docs element pElement with entry name pEntryName and type pType in 
the API for the extension with id pID. 

e ideDocsFetchExtensionEntries pID: Fetch all the data for entries in the API for the 
extension with id pID. 


The pID is the full type id of the extension, for example to fetch the documentation entries for 
the clock widget, use 


ideDocsFetchExtensionEnties "com. livecode.widget.clock" 


ideDocsFetch...Data returns a numerically keyed array, each element of which is the array of 
data about a docs entry with the given name in the specified library. 


ideDocsFetch...DataOfType returns the array of data about the unique docs entry with given 
name and type in the specified library. 


ideDocsFetch...ElementOfType returns a specific element of the array of data about the 
unique docs entry with given name and type in the specified library. 


ideDocsFetch...Entries: returns all the data for entries in the specified library. 


Extension folder locations within the IDE (8.0.0-dp-9) 


If you write plugins, or have code that relies on the location of extensions then please ensure you 
use the following access functions to locate them: 


e revEnvironmentExtensionsPath: returns the path to the folder where the IDE looks for 
packaged extensions to load (by default, this is My Livecode/Extensions ) 

e revEnvironmentUserExtensionsPath: returns the path to the folder where the IDE looks 
for user-installed extensions to load. 


When building from source, revEnvironmentExtensionsPath returns the location in the 
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binaries folder to which the packaged extensions have been extracted. 


Property Inspector editorList editor (8.0.0-dp-8) 


A new editor has been added to the list of property inspector editors which lays out a series of 
copies of a specified subeditor to control a string property. 


For example, the segmented control widget has a property segmentIcons, which is a comma 
delimited list of names of icons. 


In the widget metadata, we have 


metadata segmentIcons.editor is "com. livecode.pi.editorlist" 
metadata segmentIcons.subeditor is "com. livecode.pi.svgicon" 
metadata segmentIcons.delimiter is "," 


This tells the property inspector that each icon in the sequence should be controlled by the 
svgicon editor, and the property as a whole is delimited by ",". 


Property Inspector tabs display icons or labels (8.0.0-dp-8) 


The tabs in the property inspector can now display icons or labels according to user preference. 


Property Inspector tabs have large icons by default (8.0.0-dp-8) 


The default palette header size is now "large". Moreover, a new option "largest" has been added to 
the palette header size options. 


Per-version IDE stack filenames (8.0.0-dp-6) 


When a binary stackfile is rewritten in the IDE for a new version, it now has a (major) version in the 
filename to prevent unwanted IDE merging between versions. This can also be used to ensure 
incompatible stacks are not loaded if present - the IDE will only load stacks with a version less 
than or equal to its version. 


For example, from 8.0 onwards, the "revideLibrary" stack has filename 
/Toolset/libraries/revidelibrary.8.livecodescript. 


Variable viewer resizable columns (8.0.0-dp-6) 


The variable viewer's tree view widget display now has its showSeparator property set to true, 
which allows the user to resize the columns of its display. 


General IDE improvements (8.0.0-dp-3) 
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Menu bar 


The menubar has been made a script-only stack to facilitate bugfixes and community 
contributions. Users should not notice much difference in terms of its appearance. Some of the 
menu items have been changed, however. 


The "New Mainstack" item now has a submenu with a range of size choices, as well as the option 
to create a Script-only stack. Selecting script-only stack will prompt a choice of name, and 
subsequently open the stack in the script editor. 


We have centralised the building and handling of contextual menus in the menubar script, thereby 
making per-object contextual menus display and behave consistently throughout the IDE. 


The "Object ~ New Control" submenu is now generated based on the property information 
present for each object type, and the newly added "Object — New Widget" submenu is generated 
based on the currently loaded widget extensions. 


Widget metadata and the IDE 


Widget metadata now controls a number of additional features with respect to how the widget 
interacts with the IDE. 


Firstly, the preferredSize attribute controls the initial size of the widget when dragged out from 
the tools palette. For example, the navbar widget now has 


metadata preferredSize is "320,49" 


so that when dragged out, it is created at the correct size for an original iPhone screen. 


Secondly, the userVisible attribute controls whether the widget appears at all in the tools 
palette of the IDE. 


A number of widgets have been declared user invisible for this release, either because they are 
not meant to be draggable objects at all (eg the icon picker widget, which is designed to be 
popped up) or are not quite refined to the point where they are suitable for user stacks, but are 
included because they are being used in the IDE (for example the tree view widget). 


Finally, if present, the SvgIcon attribute will be used to display an icon for the widget in the tools 
palette, taking precedence over the included icon resources. All of the widgets included by default 
in the tools palette now use svg icon paths. 


Standalone Settings 


A field has been added to the "Copy Files" tab of the standalone settings which is populated with 
the list of currently installed extensions. All selected extensions from this list are included in 
standalones and loaded when the standalone is launched. Dependencies between extensions 
declared in the LiveCode Builder source code using use are automatically calculated and included 
along with the top-level widget. 


apes Property Inspector with support for widgets (8.0.0-dp- 
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The property inspector has been rewritten to allow properties of widgets to be inspected and 
edited. It has been implemented with flexibility and extensibility in mind, since it must be able to 
control the values of widget properties in any way required by the widget developer. Each property 
now has a number of attributes which affect how it appears in the inspector. 


Property Attributes 
The following property attributes are supported: 


e default: The default value of the property. If there is no default value (for example the loc 
property does not have one), the string "no_default" can be used. The property inspector 
pops up a contextual menu when editors are right-clicked allowing the user to set the 
property back to a default value. 


e editor: The editor that will be used to display the value of the property and allow it to be 
edited. See the dedicated section below for details on property inspector editors. 
e group: Properties are grouped by themselves in the inspector by default. If a particular 


group name is specified for a set of properties, their editors are placed next to each other 
in the inspector. 


e label: The label to use for this property. 

e options: For properties whose value is a choice from a set of options, that set should be 
specified as a comma delimited list for the options attribute. Default editors are provided 
for "enum" type properties (choice of exactly one from a set) and "set" type properties 
(choice of zero or more from a set). 


e section: The section attribute controls which tab of the property inspector contains the 
property in question. The following sections are currently supported: 


°o "Basic" 

© "Data Grid" 
o "Custom" 
° "Table" 

° "Colors" 

o "Effects" 

° "Icons" 

°o "Position" 
o "Text" 


e user visible: Properties are visible in the property inspector by default. Set the 
user visible attribute to false to hide a given property from the user. 
e read only: Read only properties will be displayed in the property inspector but the 


corresponding editor will have its editorEnabled property set to false. See the "Editors" 
section below for more details on enabled/disabled editors. 


The default and options attributes can have their values generated dynamically at runtime 
using LiveCode Script, by using the execute keyword in the attribute value. Whatever remains in 
the it variable after executing the specified script is used as the list of options. 


For example, the options for the textFont property are generated by setting the options 
property to execute: get the fontNames; sort it. 
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Widget Properties 


Widget metadata is used to control the display of widget properties in the inspector. Items of 
metadata which determine property attributes are of the form: 


metadata <property>.<attribute> is "<value>" 


These are stored as property data for the widget at load time. The <attribute> can be any of 
those specified in the "Property Attributes" section above. If the attributes are not specified, their 
values are as follows: 


e default: "no_default" 

e editor: "com.livecode.pi.number" for Integer/Real properties, "com.livecode.pi." for 
properties of type "". 

e group: the name of the property 

e label: the name of the property 

e options: empty 

e section: "Basic" 

e user visible: true 

e read only: true if there is no specified "set" handler or variable for the property, false 
otherwise. 


Script Object Properties 


Script-level properties of objects (including widgets) are specified in files in the 
Toolset/resources/supporting files/property definitions folder. The 
propertyInfo.txt file specifies the default values for all the property attributes. Each object 
type then has a specification of which properties should be displayed in the inspector when it is 
the selected object, and any options/default/group values which override the defaults. 


Editors 


Currently an editor must be a stack consisting of a group named "template" and a button named 
"behavior". The property inspector looks up the specified editor for a given property, clones the 
template group, and sets its behavior to the long id of the button. 


The behavior script must at a minimum implement the following three handlers: 


on editorInitialize 
on editorUpdate 
on editorResize 


There are a number of properties available to any editor: 


e editorMinWidth 
e editorMaxWidth 
e editorEnabled 
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e editorEffective 
e editorValue 


These should be set or got appropriately. For example, if an editor consists of a text field, the 
editorUpdate handler should update the value of the field with the editorValue of me. 
Similarly, if the content of the field changes, the field should call a function in the behavior which 
sets the editorValue of me to the content of the field. 


The editorEnabled and editorEffective properties are set by the generic behavior depending 
on the property info and the values of the properties. The editorEffective is true if the value of 
the property in question is empty but there is an effective value in play. The editor should alter the 
display of its value accordingly. 


Editors can specify their min and max width if required. 
The following editors are built-in, and available to use for widget properties with common types: 


e com.livecode.pi.array: a Tree View widget 

e com.livecode.pi.boolean: a check box 

e com.livecode.pi.color: a color swatch and dialog 

e com.livecode.pi.colorwithalpha: a color swatch and dialog, and alpha value slider 

e com.livecode.pi.enum: an option menu 

e com.livecode.pi.file: a file selector 

e com.livecode.pi.number: a single-line field, with a slider if the property has an 
associated min/max and an increment/decrement twiddle if it has a step value 

e com.livecode.pi.pattern: a pattern selector 

e com.livecode.pi.set: a field with multi-select list behavior 

e com.livecode.pi.string: a single-line field 

e com.livecode.pi.text: a multi-line field 

e com.livecode.pi.point: an editor for a point (e.g. the hotspot and loc properties) 

e com.livecode.pi.svgicon: an editor for an SVG icon; the property using the editor gets 
set to the name of the icon picked 

e com.livecode.pi.timezone: contains a drop-down list of time zones 


There are also some bespoke editors for particular object properties: 


e com.livecode.pi.customprops 
e com.livecode.pi.datagrid 

e com.livecode.pi.textalign 

e com.livecode.pi.textstyle 

e com.livecode.pi.graphiceffect 
e com.livecode.pi.gradientramp 
e com.livecode.pi.script 


It is our intention that ultimately a widget alone will be able to function as a property editor, 
however currently this feature is not available. 


Specific IDE bug fixes 


e Bugs fixed in 8.0.0: 16955, 17369, 17397, 17404, 17410, 17464, 17465. 
e Bugs fixed in 8.0.0-rc-1: 15715, 16070, 16277, 16414, 16583, 16623, 16689, 16748, 16788, 
16826, 16838, 16845, 16847, 16858, 16863, 16909, 16966, 17034, 17044, 17048, 17077, 
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17079, 17120, 17129, 17158, 17162, 17167, 17170, 17172, 17175, 17176, 17184, 17192, 
17233, 17238, 17240, 17241, 17279, 17298, 17301, 17319, 17321, 17331, 17332. 

e Bugs fixed in 8.0.0-dp-16: 15610, 16725, 16780, 16843, 16922, 16992, 16993, 17001, 
17144, 17155, 4314. 

e Bugs fixed in 8.0.0-dp-15: 1013, 16678, 16749, 16787, 16837, 16841, 16860, 16867, 
16874, 3172, 3218, 4146, 7971, 8358. 

e Bugs fixed in 8.0.0-dp-14: 15588, 16676, 16751. 

e Bugs fixed in 8.0.0-dp-13: 16605, 16615, 16640, 16641, 16651, 16672, 16674, 16675. 

e Bugs fixed in 8.0.0-dp-12: 14510, 14511, 14745, 15915, 16106, 16549, 16575, 16585. 

e Bugs fixed in 8.0.0-dp-11: 14741, 15540, 15995, 16063, 16165, 16311, 16312, 16369, 
16422, 16464, 16483, 16503, 16510. 

e Bugs fixed in 8.0.0-dp-10: 14486, 15784, 15974, 16423, 16429, 16432, 16433. 

e Bugs fixed in 8.0.0-dp-9: 15554, 16060, 16100, 16175, 16190, 16281, 16327, 16336, 
16361, 16371, 16398. 

e Bugs fixed in 8.0.0-dp-8: 15603, 16088, 16136, 16140, 16144, 16149, 16158, 16169, 
16176, 16213, 16242, 16248, 16266, 16271, 9159. 

e Bugs fixed in 8.0.0-dp-7-live-3: 16127, 16132. 

e Bugs fixed in 8.0.0-dp-7-live-2: 16016, 16065, 16071, 16099, 16101, 16105, 16129, 16138. 

e Bugs fixed in 8.0.0-dp-6: 11755, 12880, 13159, 13191, 13215, 13343, 13362, 13398, 
13417, 13447, 13475, 13646, 14561, 14738, 14822, 14831, 14852, 14873, 14890, 14971, 
15001, 15180, 15216, 15220, 15227, 15235, 15247, 15285, 15293, 15323, 15427, 15430, 
15464, 15542, 15600, 15601, 15739, 15744, 15745, 15755, 15757, 15759, 15769, 15770, 
15776, 15786, 15787, 15788, 15791, 15792, 15793, 15794, 15795, 15796, 15801, 15803, 
15824, 15825, 15827, 15832, 15838, 15841, 15842, 15843, 15847, 15854, 15859, 15882, 
15893, 15926, 15947, 15961, 15962, 15972, 15975, 15985, 15998, 16000, 16010, 16011, 
16013, 16023, 16025, 16028. 

e Bugs fixed in 8.0.0-dp-1: 14627. 


LiveCode Builder Host Library 


Canvas library 


e "Outer shadow’ effects now have a knockout (8oo0/ean) property. It controls whether or not 
the alpha channel of the source image is applied to the blurred shadow created by the 
effect, and defaults to true. 

e "Inner glow' effects now have a source (String) property, which determines the location 
from which the glow originates. It can be either "center" or or "edge", and defaults to "edge". 


e The spread property of a canvas effect is now clamped to the range O-1. 


e The unused opacity canvas effect property has been removed. The opacity can be set by 
specifying a color with alpha value less then 1. 


e You can nowcreate a newcanvas Effect object without setting up an array of properties. 
For example: 
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variable tEffect as Effect 
put outer shadow effect into tEffect 


Default values will be assumed for unspecified properties: 


o size: 5 

° spread: 0 
o distance: 5 
° angle: 60 


Widget library 
e Improved tools for detecting repeated clicks on widgets 


o The OnClick event is sent every time a mouseDown/mouseUp sequence is 
detected by the engine on a widget. 

o the click count expression evaluates to the number of successive clicks which 
happened close together and within a certain time of each other. 


e Widgets can pop up a menu constructed from a provided menu text using the 
popup menu <MenuText> at <Point> statement. 


e Widgets now have access to their effective font. 


o The textFont, textSize and textStyle properties have been reserved for use by the 
widget host. 

o Anewmy font expression has been added which evaluates to a Font matching the 
current effective values of the text properties that have been set on the widget. 


e Widgets now print along with other controls. 


o Widgets will be rasterized at screen resolution and then printed as an image. 
© Higher-fidelity printing of widgets will be implemented at a later date. 


e Added the ability to use widgets within popup dialog windows. 


© popup widget <Kind> at <Position> [ with properties <Properties> ]: 
Launches the named widget as a popup. The popup can return a value in the result. 

o currently popped up: Evaluates to true if this widget is part of a popup. 

© close popup [ returning <Result> ]: Closes this widget's popup, setting the 
result of the calling popup statement to <Result>. 


e Widgets now have access to their enable state. 


o The my enabled property returns true if the widget is currently enabled 

o The my disabled property returns true if the widget is currently disabled 

o If script changes the enabled (or disabled) property of the widget then an 
OnParentPropChanged message will be sent. 
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Composed widgets 


The ability to compose widget objects has been added. Widgets can either be 'host' widgets, 
created when a widget is directly embedded in a stack, or 'child' widgets which are created when a 
widget is used as a child widget within another widget. 


e A Widget type has been added, so that variables can contain references to child widget 
objects. Variables that hold widget references can be defined in the usual way, e.g. 
variable tWidget as Widget. 


e New widget syntax has been added to create, place, unplace and manipulate child widgets. 


° 


° 


a new widget <kind>: Create a widget object of the specified kind. 

place <widget> [at (bottom|top) | (below|above) <other widget>] : Add 
a child widget to this widget on the specified layer. 

unplace <widget>: Remove a child widget from this widget. 

the target: Return the child widget that started the current execution. 

my children: Return a list of the currently placed child widgets of this widget. 
property <property> of <widget>: Get or set a property implemented by a 
child widget. 

the rectangle of <widget>: Get or set the rectangle property of a child widget. 
the width of <widget>: Get or set the width property of a child widget. 

the height of <widget>: Get or set the height property of a child widget. 

the location of <widget>: Get or set the location property of a child widget. 
the enabled of <widget>: Get or set the enabled property of a child widget. 
the disabled of <widget>: Get or set the disabled property of a child widget. 
annotation <name> of <widget>: Tag child widgets with named values. 


e Events triggered on child widgets (such as OnMouseUp ) are automatically passed up to the 
parent, as long as the child's event handler returns nothing. If any event handler returns 
something, the event is considered handled and is not passed to the parent. 


e Messages posted by the child widget can be handled by the parent in an 
On<message name> handler. 


For example, if the child executes the statement: 
post "dataChanged" with [mDataArray], this can be handled in the parent by adding 
a handler public handler OnDataChanged(in pArray as Array) . Posted messages 


can only be handled by a direct parent, and a widget's script object will only receive 
messages posted by host widget, i.e. the topmost parent. 


e The Simple Composed Widget provides an example of how the host/child relationship can 
be used. 


Native code in extensions 


LiveCode Builder extensions can now contain native code libraries which LCB will use to resolve 
foreign handler references. 
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The foreign handler binding string should be of the form Libname>function to use this feature. 


In this case, the engine will look for a library Libname on a per-platform basis when the foreign 
handler needs to be resolved. 


Native code libraries should be present inside the resources folder inside the extension archive. 


The engine derives the appropriate path from the requested library name and current platform. 
The structure is as follows: 


<extension>/ 
resources/ 
code/ 
mac/ 
<library>.dylib 
Linux-x86/ 
<library>.so 
Linux-x86_64/ 
<library>.so 
win-x86/ 
<library>.dll 


Note: At present, only the desktop platforms are supported. 


Note: The above structure is likely to change in a future release. In particular the code folder will 
sit at the same level as resources rather than within it. 


LiveCode Builder Standard Library 


Date and time 


e The date items returned by the local time are now adjusted so that the year and 
month are absolute, rather than offsets from 1900 and January respectively. 


e the local date nowreturns a list with an additional 7th element. This is the local time 
zone's offset from UTC, in seconds. 


e The new the universal date expression provides the date in the UTC+00:00 timezone. 
It returns a list in the same format as the local date. 
Mathematical functions 
e Several mathematical functions now throw "domain errors" when applied to values that the 
function is not defined for, including log10(), ln(), asin() and acos(),and x * y. 
Foreign function interface 


e The following deprecated foreign type names have been removed from the 
com. livecode. foreign module: 
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© pointer (replaced by Pointer) 

© bool (replaced by CBool) 

© uint (replaced by UInt32 or CUInt) 

© int (replaced by Int32 or CInt) 

o float (replaced by Float32 or CFloat) 

o double (replaced by Float64 or CDouble) 

o NativeCString (replaced by ZStringNative) 


e An IntSize foreign type has been added, which should be used to represent a signed 
memory extent. It maps to the ssize t C library type. 
Sorting 
e Lists can now be sorted using an arbitrary comparison handler. 


o Anew SortCompare handler type has been added to the sort module. A handler 
that conforms with SortCompare might be declared like: 


MyComparisonHandler(in pLeft as any, in pRight as any) returns 
Integer 


© To sort using a SortCompare handler, use the new 
sort <List> using handler <SortCompare> statement. 
Sequence operations 


e New syntax has been added for searching partial contents of sequence types (List, 
String and Data) based on the offset operation. 


o the offset of <Needle> before <Position> in <Haystack> 
o the offset of <Needle> after <Position> in <Haystack> 
o Equivalent syntax has been added for the index operation. 


LiveCode Builder Language 


Property definitions 


e It is now possible to define a property named with a string instead of an identifier. This 
allows properties to have names that are also used as syntax keywords. 


Expressions 


e It is now possible to use array constants and array expressions in LiveCode Builder 
programs. For example: 
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put {"key": true} into tArray 


Keys in array literals must be strings. 
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e The precedence of LCB syntax operators has been reworked to use a defined set of 23 
named precedence classes. This is to ensure predictable and consistent interactions when 


multiple LCB operators are used in a single expression. 


There only change that is likely to significantly affect pre-existing LCB code is the reduction 
in precedence of the logical not operator to below that of comparison operators. This may 
allow removal of parentheses in the condition clauses of if statements. 


e use declarations may now occur anywhere in a module's top-level context. 


e Syntax keywords are no longer permitted to match [A-Z0-9 .]. 


e metadata definitions may now occur anywhere a module's top-level context. 


Type definitions 


e It is now possible define foreign handler types: 


foreign handler type MyCallback(in pContext as optional pointer, in 
pValue as any) as CBool 


When used in the context of a foreign handler definition, a foreign handler type will cause 
automatic bridging of the LCB handler to a C function pointer which can be called directly by 
the native code. 


The function pointers created in this fashion have lifetime equivalent to that of the calling 
context. In particular, for widgets they will last as long as the widget does, for all other 


module types they will last as long as the module is loaded. 


Core types 


e The following deprecated core type names have been removed: 


° 


boolean (replaced by Boolean) 
integer (replaced by Integer) 
real (replaced by Real) 
number (replaced by Number ) 
string (replaced by String) 
data (replaced by Data) 

array (replaced by Array) 
list (replaced by List) 
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e The use of the keyword undefined is now deprecated. Use nothing instead. 


o Use returns nothing when defining a handler which returns no value. 
o Use nothing to indicate no value when manipulating optionally type variables 


e The is defined, is undefined, is not defined, and is not undefined syntax is 
now deprecated. Use is and is not with nothing instead. 


o Use <expr> is nothing and <expr> is not nothing to test whether an 
expression has a value or not 
o The expression <left> is <right> will now evaluate to true if <left> and 
<right> are both nothing 
o The expression <left> is not <right> will now evaluate to true if one of 
<left> or <right> are nothing (but not both). 
Identifiers 


e All identifiers are now case-insensitive - i.e. a handler Main can be called as mAin, MAIN 
and main. 


e Identifiers are now expected to match [A-Z0-9 .]. 


Handler definitions 


e The syntax for declaring the type of the return value from a handler (or handler type) is now 
[ 'returns' 'nothing' | ‘'returns' <Type> ]. 


e Foreign handler definitions now require explicit typing. 


° A foreign handler definition must declare an explicit return type. 
o Each parameter in a foreign handler definition must declare an explicit type. 


LiveCode Builder Tools 
Ic-compile 
Errors 


e List expressions with more than 254 elements will now generate an error. 
e Array expressions with more than 127 key-value pairs will now generate an error. 


e Array constants with non-string keys will now generate an error. 


e Integer literals that are too big to fit into an unsigned 32-bit integer representation will now 
generate a compilation error. 


Command-line interface 
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e The new -Werror command line flag converts all compilation warnings into errors. 


e Anew --verbose command line flag has been added. If it is specified, Ic-compile will 
output additional debugging information. 


Manifest 
e A module now outputs its type to the manifest XML. 
Warnings 
e Anewwarning has been added for identifiers that may conflict with syntax keywords. 


e metadata definitions that occur before module imports no longer trigger a warning. 


Specific LCB bug fixes 


e Bugs fixed in 8.0.0-rc-1: 14995, 17004, 17313, 17352, 17356. 

e Bugs fixed in 8.0.0-dp-16: 14980, 15634, 16744, 17090. 

e Bugs fixed in 8.0.0-dp-13: 16681. 

e Bugs fixed in 8.0.0-dp-12: 14963, 15429, 15440. 

e Bugs fixed in 8.0.0-dp-11: 14546, 14930, 16400, 16465. 

e Bugs fixed in 8.0.0-dp-9: 14929, 15435. 

e Bugs fixed in 8.0.0-dp-7: 15502, 16053. 

e Bugs fixed in 8.0.0-dp-6: 15916, 15966, 16006. 

e Bugs fixed in 8.0.0-dp-5: 14809, 14809, 15833, 15941. 

e Bugs fixed in 8.0.0-dp-4: 15773. 

e Bugs fixed in 8.0.0-dp-3: 14500, 14541, 14678, 14679, 14681, 14805, 14806, 14846, 
14889, 14893, 14898, 14906, 14926, 14933, 14938, 14939, 14950, 14956, 14964, 14991, 
14993, 14996, 14997, 15005, 15012, 15029, 15035, 15060, 15115, 15128, 15138, 15152, 
15276, 15284, 15331, 15410, 15426, 15489, 15529, 15628, 15681, 15768. 

e Bugs fixed in 8.0.0-dp-1: 14599, 14871. 
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Navigation Bar widget 


Theming and appearance 


e The navbar colors are now controlled by the standard LiveCode foregroundColor, 
backgroundColor, hiliteColor and borderColor properties. They can be edited in the 
property inspector. 


e The visibility of the border at the top edge of the navbar is now controlled by the standard 
LiveCode showBorder property, which can be edited in the property inspector. 


e There are no longer separate Android and iOS themes for the navbar. 
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Properties 
e The widgetTheme property has been removed. 


e The background Opacity property has been removed, and has been replaced by the 
Opaque property which can be set to true or false. 


e The showDivide property has been renamed to showBorder. 

e The navData property has been renamed to itemArray. 

e The navNames property has been renamed to itemNames. 

e The navicons property has been renamed to itemlcons. 

e The navSelectedicons property has been renamed to hiliteditemlcons. 
e The navLabels property has been renamed to itemLabels. 

e The selecteditem property has been renamed to hiliteditem. 


e AnewhiliteditemName property has been added. It contains the name of the currently- 
highlighted item. It can be set to change which item is highlighted. 


e The itemArray for a navbar widget can now be empty. 


e editMode should default to "false" 


Signals 


e The navigate signal has been renamed to hiliteChanged, and no longer passes any 
arguments. The currently-highlighted item can be accessed in a hiliteChanged handler by 
using the hiliteditem and/or hilited ItemName properties. 


Switch Button widget 


Theming and appearance 


e The switch button is now drawn the same size for both its "iOS" and "android" themes. It is 
no longer possible to resize the bounding box of the switch button so that some of it is "cut 
off" at the edges. 


e The switch button now uses the theme property to control its appearance. Currently, the 
theme property is not saved, and is reset to "native" whenever the widget is loaded. 


e The switch button colors are now controlled by the standard LiveCode hiliteColor, 
borderColor and backgroundColor properties. They can be edited in the property 
inspector. 


e The switch button now obeys the standard LiveCode showBorder property, which can be 
edited in the property inspector. 


Properties 
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The widgetTheme property has been removed. Use the theme property instead. 


The colorScheme property has been removed. Set the hiliteColor, borderColor and 
backgroundColor properties instead. 


The switchlsOn property has been removed. Use the hilited property instead. 


Signals 


The switchChanged signal has been renamed to hiliteChanged. 


Default script 


The switch button now has a default script. 


Header Bar widget 


Theming and appearance 


The header bar colors are now controlled by the standard LiveCode foregroundColor, 
backgroundColor, hiliteColor and borderColor properties. They can be edited in the 
property inspector. 


The visibility of the border at the bottom edge of the header bar is now controlled by the 
standard LiveCode showBorder property, which can be edited in the property inspector. 


The header bar now uses the theme property to control its appearance. Currently, the 
theme property is not saved, and is reset to "native" whenever the widget is loaded. 


Properties 


The widgetTheme property has been removed. Use the theme property instead. 


The colorScheme property has been removed. Set the hiliteColor, borderColor and 
backgroundColor properties instead. 


The actionColor property has been removed. Use the hiliteColor property instead. 


The leftLabel and showBacklcon properties have been removed. Use the firstitemLeft 
property instead. 


The headerSubtitle property has been removed. 

The distinctTitle property has been removed. 

The headerrTitle property has been renamed to label. 

The titleVisibility property has been renamed to showLabel. 

The background Opacity property has been renamed to opaque. 
The showDivide property has been renamed to showBorder. 

The actionData property has been renamed to itemArray. 
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e The actionNames property has been renamed to itemNames. 

e The actionicons property has been renamed to itemlicons. 

e The actionSelectedicons property has been renamed to hiliteditemlcons. 
e The actionLabels property has been renamed to itemLabels. 

e The actionStyle property has been renamed to itemStyle. 


e Anewproperty firstltemLeft has been added. If true, the first action in the itemArray is 
displayed on the left hand side of the header bar. On iOS, the icon and label of a left action 
are both drawn. On Android, only the left action icon is drawn. 


e Anewread-only mouseAction property has been added. It contains the name of the 
action item that the mouse is currently over, or empty if there is no such action. 


Signals 


e The headerAction, leftAction and backAction signals have been removed. To execute 
code in response to an action being clicked, use a combination of the mouseUp signal and 
the mouseAction property. 


Documentation 


The messages posted by the header bar widget have been documented. 


Line Graph widget 


hilitedCoordinatesColor Property 


The hilitedCoordinatesColor property can be used to control the color of the lines and point used 
to indicate the hilitedCoordinates. 


x-axis labels 


The labels for the graph widget x-axis are now displayed. 


hilitedCoordinates Property 


The graph widget now has a hilitedCoordinates property, which allows the point corresponding to a 
particular pair of values to be indicated on the graph. The point does not have to coincide with any 
data point currently displayed on the graph. 


The hilitedCoordinates are indicated by an additional circular point at the specified location, as well 
as dotted lines going from the point to both the axes. 


Gradient Ramp Editor widget 


Selected stop API 
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selectedStop property 


The gradient ramp widget now has a selected Stop property whose value is the index of the 
widget's selected gradient stop, or 0 if there is no selected stop. 


selectedStopChanged message 


The gradient ramp widget posts a selectedStopChanged message when the selected stop of 
the widget is changed either by script (via the selectedStop property) or by user interaction, i.e. 
clicking on one of the widget's gradient stops. 


SVG Icon widget 


Properties 


e AnewfillRule property has been added. It is an enum that can be set to "non-zero" or 
"even odd", and it is "non-zero" by default. 


e All properties are now fully integrated into the IDE Property Inspector. 


e The iconColor and iconHiliteColor properties have been removed. Set the standard 
LiveCode foregroundColor and hiliteColor properties instead. 


e The isHilited property has been removed. Use the standard LiveCode hilited property 
instead. 


e The iconPathPreset property has been renamed to iconPresetName to more 
accurately reflect the information it contains. 


e The flipVertically property has been renamed to flipped. 
e The iconAngle property has been renamed to angle. 


e The toggleHilite property has been removed, since the SVG path widget no longer 
handles any mouse events. 


e The property inspector editor for the iconPathPreset property is now an instance of the 
SVG Icon widget itself, which pops up the Icon Picker widget when clicked. 
Theming and appearance 


e The SVG path widget's paints are now controlled by the standard LiveCode 
foregroundColor and hiliteColor properties, and can use patterns. They can be edited in 
the Property Inspector. 

Signals 


e The SVG path widget no longer handles any mouse events. It passes the the mouseDown, 
mouseUp, mouseEnter and mouseLeave messages on to its widget script. 


o The previous non-toggling behaviour can be reproduced using a script similar to: 
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on mouseDown 
set the hilited of me to true 
end mouseDown 


on mouseUp 
set the hilited of me to false 
end mouseUp 


o The previous toggling behaviour can be reproduced using a script similar to: 


on mouseUp 
set the hilited of me to (not the hilited of me) 
end if 


Default script 


e The SVG path widget now has a default script. 


Palette Actions widget 


Palette actions order 


The palette actions widget now uses the sort using handler syntax to sort the elements of its data 
array, in order to sort numerically. 


Clock widget 


Time zone handling 
e The timeZone property can now be set to empty to use whatever the local time is. 


e The timeZone property now contains the time zone offset from UTC in seconds, rather 
than hours. 


Browser widget 


Signals 


e Anew browserUnhandledLoadRequest message is sent to the widget's script object 
when the browser is unable to load a URL, typically due to an unrecognised URL scheme. 
The pUrl parameter contains the URL of the unhandled request. 


New Browser Widget 
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A new embeddable browser browser widget has been added, making it much easier to use than 
the old revbrowser external. 


To add a browser to your application, simply drag and drop the browser widget onto your stack 
and set the properties you need. 


Properties 


e url - The URL of the page displayed in the browser. 

e htmitext - The HTML source of the content displayed in the browser 

e vscrollbar - Whether or not the browser displays a vertical scrollbar 

e hscrollbar - Whether or not the browser displays a horizontal scrollbar 

e userAgent - The identifier sent by the browser when fetching web content. 

e javascriptHandlers - A list of object script handlers that can be called by javascript code 
in the page loaded in the browser. 


Messages 


e browserDocumentLoadBegin pUrl - sent when a new document has completed loading 
in the browser. 

e browserDocumentLoadComplete pUrl - sent when a new document has completed 
loading in the browser. 

e browserDocumentLoadFailed pUrl, pError - sent when a new document has failed to 
load in the browser. 

e browserFrameDocumentLoadBegin pUrl - sent when a new document has completed 
loading in a frame of the browser. 

e browserFrameDocumentLoadComplete pUrl - sent when a new document has 
completed loading in a frame of the browser. 

e browserFrameDocumentLoadFailed pUrl, pError - sent when a new document has 
failed to load in a frame of the browser. 

e browserNavigateBegin pUrl - sent when the browser begins navigation to a new page. 

e browserNavigateComplete pUrl - sent when the browser successfully navigates to a 
new page. 

e browserNavigateFailed pUrl, pError - sent when the browser has failed to navigate to 
a new page. 


Browser widget kind 


The browser widget kind has been changed from com.livecode.extensions.livecode.browser 
to com.livecode.widget.browser. 


This means users will be required to replace any existing browser widgets on their stacks with a 
new copy. 


Tree View widget 


Theming and Appearance 


e The tree view widget has been reworked to make it more fully integrated into the IDE and 
behave more like a classic control. 
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o The tree view now uses the built-in color properties backgroundColor, 
foregroundColor, hiliteColor and borderColor for its colors. When no colors are 
set, it will use a set of generic native theme colors. 


o The borderColor is now used as the color for the separator, if present. The 
separator is now drawn with a stroke width of 1, but its hit rect extends 2 pixels either 
side of the line. 


Properties 
e The tree view now uses standard property names (where they exist) for its properties. 


o sShowFrameBorder is now called showBorder 
oe selectedRowColor is now called hiliteColor 


The tree view widget now has the ability to sort the keys of its arrayData in different ways. Two 
properties have been added to achieve this: 


e sortOrder: either "ascending" or "descending" 
e sortType: either "text" or "numeric". 


The default sort order of the widget is ascending numeric. 


Two new properties have been added in order to allow the key-value pairs of the tree view to be 
displayed in separate columns: showSeparator and separatorRatio. 


The showSeparator property controls whether the tree view is in columns or not. The 
separatorRatio property controls where the separator is. More specifically, it is the proportion of 
the view space that is taken up by the key column. 


When the showSeparator property is true, the separator can be dragged by the user to resize 
the columns. 


Signals 
e The selectedElementChanged signal has been renamed to hiliteChanged. 


When in read only mode, the tree widget will now display an ‘open in new window icon if the value 
of the array at the specified path contains a newline character, or is too large to display in the 
widget. 


If this icon is clicked, an actionInspect signal is emitted. It has one parameter: the path 
associated with the clicked row. When a leaf node of the tree is double-clicked, an 
actionDoubleClick signal is emitted. It has one parameter: the path associated with the 
clicked row. 


Icon Picker widget 


Layout calculations 
The icon size of the icon picker is now fixed at 65 pixels. The number of rows/columns therefore 


now depends on the height/width. The widget will clip instead of reducing the number of rows or 
columns to below 3. 
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The preferredSize of the icon picker is now calculated as the minimum size to display 5 rows 
and columns of icons in the view. 


Segmented Control widget 


Properties 


e The segmented control widget has been reworked to make it more fully integrated into the 
IDE and behave more like a classic control. 


The segmented control now uses standard property names for its properties (where they 
exist). 


o multiSelect is now called multipleHilites 

o ShowFrameBorder is now called showBorder 

© segmentColor is now called backColor 

© segmentLabelColor is now called foreColor 

o selectedSegmentColor is now called hiliteColor 

© segmentSelectedLabelColor is now called hilitedTextColor 


e All of the existing properties previously named segment<property> have been renamed 


to use the word item. This is in order to unify related property names of several different 
widgets. 


© segmentCount is now itemCount 

o segmentDisplay is now itemStyle 

°o segmentNames is now itemNames 

o segmentLabels is now itemLabels 

° segmenticons is now itemicons 

© segmentSelectedicons is now hiliteditemicons 
© segmentMinWidth is now itemMinWidths 

o selectedSegments is now hiliteditems 


e Anew property hilitedItemNames has been added, which contains. the names of the 
currently highlighted segments, as opposed to hililtedIitems which returns their indices. 


e The style property has been removed. 


Appearance and Theming 


e When no colors are set on the segmented control, it will use a set of native theme colors 
associated with a list field. 


Signals 


e The segmentSelected and segmentUnselected signals have been removed. Use the 
hiliteChanged message instead. 


e The hiliteChanged message no longer has a parameter. Use the hilitedItems or 
hilitedItemNames properties as required to obtain the new highlight state. 
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Segment widths 


When the segmented control's segmentDispLlay property is set to "text", the widths of the 
segments are calculated using the following rules: 


e Measure the text, and assign widths accordingly 
e Increase the size of any segments that are smaller than the corresponding 


segmentMinWidth 
e If there is any space left in the widget bounds, increase each segment's size to fill the space 


If after measuring and increasing to take min widths into account the segments will not fit, the 
segmented control will clip the content rather than shrink it. 


Segment Colors 


Four new properties have been added to the segmented control: 


e segmentColor: the background color of the unselected segments 
e segmentSelectedColor: the background color of the selected segments. 
e segmentLabelColor: the label color of the unselected segments. 
e segmentSelectedLabelColor: the label color of the selected segments. 


Where any of these are empty, the control instead uses its associated default color. 


This feature was sponsored by FMProMigrator. 


Segment Count 
A segmentCount property has been added to the segmented control. 
This controls the number of segments. If it is less than the current number of segments, 


segments will be deleted from the right. If it is more, segments will be added with default icons 
(circle), labels ("Title") and names ("segment"). 


Icon SVG Library 


Icon families 


e Icons are now organized by "family", and divided into two icon families by default: a 
"fontawesome" family and an "ide" family. The "fontawesome" family is the default family. 
This is to enable future extensibility. 


e The iconNames() handler now lists only the icons in the default family. 
e The iconSVGPathFromName() and iconCodepointFromName() handlers now accept icon 


names in the form "name" or "family/name". If no family part is present, they will search the 
default family, followed by any other available families. 


JSON Library 
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JSON Library Added 


An LCB library, com.livecode.library.json, has been written to provide support for generating 
and parsing JavaScript Object Notation (JSON) data. See also http://json.org. 


Functions 


The library has two public handlers, JsonImport and JsonExport. JsonImport takes a string 


containing JSON-formatted text and parses it into a LiveCode value. JsonExport takes a 
LiveCode value and returns the equivalent value as a string in JSON format. 


Using the library 


The library is automatically loaded into the IDE, and the JsonImport and JsonExport handlers 
placed in the message path where they are available to call from any object. 


In LiveCode Script, JsonExport takes any value and converts it to a string representing a JSON 
encoded value. 


To use the library from a LiveCode Builder widget or library, simply add it to the list of use clauses: 


use com. livecode.library.json 


When using the JsonExport handler in LCB, an error is thrown if the value passed is not of one of 
the following types: 


e String 
e Number 
e List 

e Array 

e Boolean 
e nothing 


Examples 


From LiveCode Script: 


local tData, tJSON 

put "a,b,c,d" into tData 

split tData by comma 

Ou JISOME ore (tDEcE))) aie ISON == Convedins {Miles “ah ,"2"2 Moy, 7373 Ter, Vals 
"qd" } 


From LiveCode Builder: 
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variable tJSON as String 
OURE Wolpe Sp Soll” aiMe® wISON 


variable tData as List 
put JsonImport(tJSON) into tData -- contains [1,1,2,3,5,8] 


Widget Utilities module 


Utility module added 


A module, com.livecode.widgetutils, has been written to provide support for functions 
commonly needed by widgets. 


The functions are: 


constrainPathToRect: Scales and translates a Path value to fit within a rectangle 
intToString: Formats an integer as a string 

stripZeroes: Removes any superfluous zeros and decimal places from a string 
representation of a number. 

colorToString: Converts a value of type Color to an RGB or RGBA string representing the 
color 

stringToColor: Converts a comma-delimited string representing an RGB or RGBA color 
to a value of type Color. 


See the documentation for more details on the individual handlers and their syntax. 


Specific extension bug fixes 


Bugs fixed in 8.0.0-rc-1: 17078, 17159, 17191, 17194, 17310, 17322. 
Bugs fixed in 8.0.0-dp-16: 15142, 16744, 16927, 16937, 16969, 16979, 16981, 16983, 
17006, 17036, 17116, 17137. 

Bugs fixed in 8.0.0-dp-15: 16520, 16694, 16770, 16785, 16864. 

Bugs fixed in 8.0.0-dp-14: 16677. 

Bugs fixed in 8.0.0-dp-13: 16517, 16656. 

Bugs fixed in 8.0.0-dp-11: 16399, 16404, 16553. 

Bugs fixed in 8.0.0-dp-9: 16021, 16155, 16320, 16335, 16341, 16354. 
Bugs fixed in 8.0.0-dp-8: 16135, 16241. 

Bugs fixed in 8.0.0-dp-7: 15821. 

Bugs fixed in 8.0.0-dp-6: 16009. 

Bugs fixed in 8.0.0-dp-5: 15815, 15840, 15850, 15851, 16771. 

Bugs fixed in 8.0.0-dp-3: 15224. 


Dictionary additions 


e create widget (command) has been added to the dictionary. 
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deleteWidget (message) has been added to the dictionary. 

do in widget (command) has been added to the dictionary. 
documentFilename (property) has been added to the dictionary. 
export widget (command) has been added to the dictionary. 
fullClipboard Data (property) has been added to the dictionary. 
fullDragData (property) has been added to the dictionary. 

go in widget (command) has been added to the dictionary. 
import widget (command) has been added to the dictionary. 

is not strictly (operator) has been added to the dictionary. 

is strictly (operator) has been added to the dictionary. 

kind (property) has been added to the dictionary. 

launch url in widget (command) has been added to the dictionary. 
load extension (command) has been added to the dictionary. 
loadedExtensions (function) has been added to the dictionary. 
lock clipboard (command) has been added to the dictionary. 
metadata of image (property) has been added to the dictionary. 
newWidget (message) has been added to the dictionary. 

popup (command) has been added to the dictionary. 
rawClipboard Data (property) has been added to the dictionary. 
rawDrag Data (property) has been added to the dictionary. 
replace in field (command) has been added to the dictionary. 
scriptOnly (property) has been added to the dictionary. 

theme (property) has been added to the dictionary. 

themeClass (property) has been added to the dictionary. 

unload extension (command) has been added to the dictionary. 
unlock clipboard (command) has been added to the dictionary. 
widget (object) has been added to the dictionary. 
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